Filtering Messages

To reduce the volume of messages, you can filter the output using several criteria, including by file(s), message number, severity value, diagnostic type, and more. Each of the filters is combined to dictate the final output.

Filtering by File(s)

To display results for a specific source file within a Helix QAC project, the path to the source file can be provided:

qacli view -P <directory> -m STDOUT <path-to-file>

To display results for a specific set of source files within a Helix QAC project, the path to each source file must be placed in a filelist, which is a text file made up of one path per line. To view this, use the following command:

qacli view -P <directory> -m STDOUT --files <path-to-filelist>

Filtering by Message Number

To display only the specified warning messages, you can use the ‑‑only (‑O) option and specify the messages you want to see. Message numbers can be specified individually, as a list, as a range, or a combination of these, for example:

• ‑‑only 1234
• ‑‑only 1234,1236,1240
• ‑‑only 2111,2200-2300

To display only messages 1234 and 5678, you could issue the following command:

qacli view -P . --medium STDOUT --only 1234,5678

To display only messages that do not contain the specified messages, you can use the ‑‑nomsg (‑N) option and specify the messages you want to filter. To display all messages except 1234 and 5678, you could issue the following command:

qacli view -P . --medium STDOUT --nomsg 1234,5678

Filtering by Severity

To display only messages of a certain severity (or higher), use the ‑‑min‑severity (‑S) option and specify the severity level. Valid values are in the range 0-9: 0 is acceptable but will display everything.

To display high severity messages, a command such as the following might be appropriate:

qacli view -P . --medium STDOUT --min-severity 7

To display only messages with a given severity, use the ‑‑max‑severity (‑v) option and specify the severity level. Valid values are in the range 0-9: 9 is acceptable but will display everything.

To display low severity messages, you can use a command such as the following:

qacli view -P . --medium STDOUT --max-severity 2

These options can be combined to only output messages in a given severity range (for example: 5, 6 and 7):

qacli view -P . --medium STDOUT --min-severity 5 --max-severity 7

An exact severity can also be shown:

qacli view -P . --medium STDOUT --min-severity 5 --max-severity 5

The following example combines the filters and displays only high severity messages, ignoring message 1234:

qacli view -P . --medium STDOUT -S 7 -N 1234

To limit the number of times that any message is displayed, you can use the ‑‑max‑count (‑X) option. The default of 0 shows no limit is applied.

qacli view -P . --medium STDOUT --max-count 2

This command displays only the first two unique messages in each file.

Viewing Suppressed Diagnostics

By default, suppressed diagnostics are not output. To view suppressed diagnostics (in addition to all unsuppressed diagnostics), you can use the ‑‑suppression‑filter (‑T) option. This option, which can be specified multiple times, allows you to specify which suppressed diagnostics you want to output.

The following values can be specified: ALL, BASELINE, COMMENT, DASHBOARD, INTERACTIVE, MACRO, PRAGMA, and VALIDATE. The value of ALL is equivalent to the ‑‑suppressed‑messages (‑s)option, which is now deprecated.

For example, to output all unsuppressed diagnostics and the COMMENT and MACRO suppressed diagnostics:

qacli view -P <directory> -m STDOUT -T COMMENT -T MACRO

• qacli view
• Helix QAC Documentation